home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2009 February / PCWFEB09.iso / Software / Linux / Kubuntu 8.10 / kubuntu-8.10-desktop-i386.iso / casper / filesystem.squashfs / usr / share / doc / libsysfs2 / README < prev    next >
Text File  |  2006-08-23  |  2KB  |  71 lines
  1.  
  2.     Sysfs Utilities Package - Includes Libsysfs(v. 2.1.0)
  3.     ======================================================
  4.  
  5. Contents
  6. --------
  7.  1. Introduction
  8.  2. How to Install
  9.     2.1 Caveats/Known issues
  10.  3. Licenses
  11.  4. Reporting Bugs
  12.  
  13.  
  14. 1. Introduction
  15. ---------------
  16.  
  17. This package's purpose is to provide a set of utilities for interfacing
  18. with sysfs, a virtual filesystem in Linux kernel versions 2.5+ that
  19. provides a tree of system devices. While a filesystem is a very useful
  20. interface, we've decided to provide a stable programming interface
  21. that will hopefully make it easier for applications to query system devices
  22. and their attributes.
  23.  
  24. This package currently includes:
  25.  
  26. - libsysfs: a library for accessing system devices.
  27. - systool: an application to view system device information by bus, class,
  28.     and topology.
  29. - A number of example usage routines in the "test" directory.
  30. - A comprehensive testsuite, also shipped as part of the "test" directory. This
  31.     testsuite can be used to test _all_ the APIs exported by Libsysfs.
  32.     Please refer the libsysfs.txt file in the "docs" directory for
  33.     details as to how to use the testsuite.
  34.  
  35.  
  36. 2. How to Install
  37. -----------------
  38.  
  39. Run the "configure" script to generate Makefiles. Use "make" to build the
  40. library and utilities.
  41.  
  42. For a successful install, run "make install" as super-user. "make uninstall"
  43. will clean up all installed files.
  44.  
  45.  
  46. 3. Licenses
  47. -----------
  48.  
  49. The commands and tests are licensed under the GNU Public License (GPL)
  50. Version2, June 1991. The full text of the GPL is located in this package's
  51. "cmd" directory:
  52.  
  53. sysfsutils/cmd/GPL
  54.  
  55. The library is licensed under the GNU Lesser Public License (LGPL)
  56. Version 2.1, February 1999. The full text of the LGPL is located in
  57. this package's "lib" directory:
  58.  
  59. sysfsutils/lib/LGPL
  60.  
  61.  
  62. 4. Reporting Bugs
  63. -----------------
  64.  
  65. Please direct all bugs to either the linux-diag mailing list -
  66. linux-diag-devel@lists.sourceforge.net - or to the authors:
  67.  
  68. Ananth Mavinakayanahalli <ananth@in.ibm.com>
  69. Daniel Stekloff <dsteklof@us.ibm.com>
  70. Mohan Kumar <mohan@in.ibm.com>
  71.